home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / PVDRIVER / WLPRSP30.ZIP / WLPRSPL.ASC < prev    next >
Text File  |  1993-10-20  |  25KB  |  607 lines
  1.                        WLPRSPL V3.0
  2.                              
  3.                              
  4.                              
  5.        An LPR based printer spooler for Windows 3.1
  6.                              
  7.                              
  8.                     September 24, 1993
  9.                              
  10.                              
  11.                              
  12.                              
  13.                              
  14.                              
  15.                              
  16.                              
  17.                         Thomas Heil
  18.                              
  19.                      Hindenburgstr. 50
  20.                    41352 Korschenbroich
  21.                           Germany
  22.                              
  23.               E-Mail: th.heil@kfa-juelich.de
  24. This  document  was  created  with  Microsoft  Word  for  Windows
  25. 2.0
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32. DISCLAIMER:
  33.  
  34. THE   SOFTWARE  IS  PROVIDED  AS-IS.  THE  AUTHOR  DISCLAIMS  ALL
  35. WARRANTIES,  EITHER  EXPRESS  OR  IMPLIED,  INCLUDING   BUT   NOT
  36. LIMITED  TO  IMPLIED  WARRANTIES OF  MERCHANTABILITY  OR  FITNESS
  37. FOR   A   PARTICULAR  PURPOSE.  NO  LIABILITY  IS   ASSUMED   FOR
  38. DAMAGES,  DIRECT  OR  CONSEQUENTIAL, WHICH MAY  RESULT  FROM  THE
  39. USE OF THIS SOFTWARE.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52. All  trademarks  appearing  in this  document  are  the  property
  53. of their respective owners.
  54.  
  55. Table of Contents
  56.  
  57. Table of Contents                                         3
  58. Introduction                                              5
  59. Requirements:                                             5
  60. Contents                                                  5
  61. How does the spooler work?                                7
  62. Installation                                              8
  63. First Start                                               8
  64. Defining Local Queues                                     8
  65. Adjusting WLPRSPL Parameters                              9
  66. WLPRSPL Running ...                                      10
  67. WLPRSPL Menu Options                                     11
  68. Usage Notes                                              12
  69. Licensing and Registration                               14
  70.     Registration Fee                                       14
  71. Change Log                                               14
  72. One final word ...                                       15
  73. Registration Form                                        17
  74.  
  75. Introduction
  76.  
  77. WLPRSPL is a program which allows transparent printing from
  78. Microsoft  Windows 3.1 applications to printers  which  are
  79. reachable  over  a  TCP/IP network using the  LPD  Protocol
  80. (RFC1179).  The  user installs the correct printer  drivers
  81. that  match the printers he wants to use, and connects them
  82. to  a  local spool file in the same way he would connect  a
  83. driver to an LPTx port. When an application then prints  to
  84. such a printer the Windows Print Manager writes the printer
  85. data  to  the corresponding spool file and sends WLPRSPL  a
  86. special  notification  (a  WM_SPOOLERSTATUS  message).  The
  87. spool file is then renamed by WLPRSPL, entered into its own
  88. queueing system, and then later sent to the remote printer.
  89. If  the print job could be sent successfully the spool file
  90. is  deleted,  otherwise sending is retried. After  a  user-
  91. definable  number  of  unsuccessful  retries  the  user  is
  92. notified and the local queue is disabled. The user may then
  93. enable  this  queue later when all problems are eliminated,
  94. and all files queued up to this time will be sent.
  95.  
  96. Requirements:
  97.  
  98.    Microsoft  Windows  3.1 and TCP/IP  networking  software
  99.    for   the   PC  that  offers  a  WinSock  1.1  compliant
  100.    WINSOCK.DLL.
  101.    WLPR.DLL Version 1.0 or later.
  102.    WSOCKAID.DLL  Version 1.0 or later.  Users  that  run  a
  103.    TCP/IP  stack other than FTP Software's should note  the
  104.    comment in the "Installation" section below.
  105.  
  106. Contents
  107.  
  108. This  package  contains the spooler (WLPRSPL.EXE)  and  the
  109. supporting  libraries  WLPR.DLL  Version  1.0  pl   0   and
  110. WSOCKAID.DLL Version 1.0 pl 0 as well as this documentation
  111. in  form  of a Word for Windows 2.0 .DOC file and  a  plain
  112. ASCII version.
  113.  
  114. How does the spooler work?
  115.  
  116. Every  printer used within Windows is connected  to  a  so-
  117. called "port." Examples are LPT1, LPT2, COM1, COM2 etc. But
  118. also normal files can define such ports. When you enter the
  119. line
  120.    
  121.    C:\SPOOL\DRUCKER.DAT=
  122.    
  123. into the [ports] section of WIN.INI you may later connect a
  124. printer driver to this "port." Every print job sent to this
  125. port  is written to the specified file by the Windows Print
  126. Manager.  This  is what WLPRSPL relies on. WLPRSPL  uses  a
  127. dedicated directory on the PCs hard disk for spooling (i.e.
  128. C:\SPOOL).  This  directory has to be specified  the  first
  129. time  you  start the program. For each network printer  you
  130. want to print to you have to chose a unique file name (i.e.
  131. HP.PCL  for  a  HP LaserJet in PCL mode).  This  file  name
  132. together with the chosen spool directory makes the port (in
  133. this  case C:\SPOOL\HP.PCL) to which an appropriate Windows
  134. Printer Driver can be connected. The filename without  path
  135. represents the local queue.
  136. The  definitions of all local queues are kept  in  a  queue
  137. definition file (which I will abbreviate as QDF from  now).
  138. This  is an ASCII file which might be edited using a normal
  139. editor. But I suggest that this file be maintained only  by
  140. means  of  the configuration dialogs of WLPRSPL.  The  file
  141. contains lines of the form
  142.    
  143.    remote-queue remote-host spoolfile options
  144.    
  145. An example for such a line might be
  146.    
  147.    ich01a4 ich210.ich.kfa-juelich.de HP.PCL v
  148.    
  149. Each  line  in  this file defines one remote  printer.  The
  150. individual fields of such a definition are separated by one
  151. or more spaces and have the following meaning:
  152.  
  153. remote-queue Name of the printer queue on the remote  print
  154. server
  155. remote-host  Internet  hostname or address  of  the  remote
  156. print server
  157. spoolfile Unique spool file name (without path)
  158. options Printing options
  159.  
  160. If  you have selected C:\SPOOL as the spool directory,  the
  161. port  C:\SPOOL\HP.PCL would be created by the example  line
  162. above  when  the program starts and the port does  not  yet
  163. exist.  Then  you  could connect the  HP  LaserJet  printer
  164. driver to this port using the control panel. When you later
  165. print to it from any windows application, the Print Manager
  166. writes  the  printer  data  to  the  file  C:\SPOOL\HP.PCL.
  167. WLPRSPL then puts the file into its own queueing system and
  168. sends the data to the remote printer queue ich01a4 on  host
  169. ich210.ich.kfa-juelich.de.
  170.  
  171. Installation
  172.  
  173. Choose  a  directory where you want to install WLPRSPL  and
  174. create  it. Move the archive WLPSPnn.ZIP to this  directory
  175. and  unzip  it  with  PKUNZIP  WLPSPnn  or  any  compatible
  176. program.  Move all *.DLL files to the Windows directory  or
  177. to  another directory that is in your PATH, or include  the
  178. directory where you installed WLPRSPL into your PATH.  Then
  179. either  create  a  new Program Manager  group  or  open  an
  180. existing,  and install WLPRSPL.EXE there (please  refer  to
  181. your  Windows documentation on how to do this). After  that
  182. you  can  start  the program for the first time.  For  your
  183. convenience   you should also install the spooler  in  your
  184. AUTOSTART group so that it gets launched automatically when
  185. you start Windows.
  186.  
  187. A  note  about  WSOCKAID.DLL: This is  a  network  software
  188. vendor  specific  DLL  containing  a  few  functions   that
  189. WINSOCK.DLL does not offer. Currently.you will not get this
  190. DLL  from your vendor. The version in this pack was written
  191. by  me  explicitly  for FTP Software's  PC/TCP  stack.  The
  192. function  that  WLPRSPL  (or  better  WLPR.DLL)   uses   is
  193. retrieving  the  user's  login  name.  If  you   have   FTP
  194. Software's  PC/TCP 2.1 or higher, this DLL  will  take  the
  195. needed  information from the PCTCP.INI  file  (or  whatever
  196. your  PCTCP environment variable is set to). If you  use  a
  197. different  stack, you may create the following  section  in
  198. your  WIN.INI in order to make this version of WSOCKAID.DLL
  199. work:
  200.  
  201.          [WSockAid]
  202.